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Data Access in Client and Middle-Tier Programming 

How to: Read Excel Data into a Dataset (Visual Basic) 

S ee Also Examp le 

v Language Filter: Visual Basic 

This example reads data from an Excel spreadsheet into a dataset. 

Example 

Visual Basic _j Copy Code 

Dim cn As System . Data . OleDb . OleDbConnect ion 
Dim cmd As System . Data . OleDb . OleDbDataAdapter 
Dim ds As New System . Data . DataSet ( ) 

cn = New System. Data .OleDb. OleDbConnect ion ( "provider=Microsof t .Jet .OLEDB. 4 . ; " & 
"data source=C: \myData.XLS, -Extended Properties=Excel 8.0;") 

' Select the data from Sheetl of the workbook. 

cmd = New System . Data . OleDb . OleDbDataAdapter (" select * from [Sheetl$]", cn) 

cn .Open ( ) 
cmd. Fill (ds) 
cn . Close ( ) 



Compiling the Code 

This example requires: 

• A project reference to System.data.dll. 

• Access to the members of the System. Data namespace. Add an Imports statement if you are 
not fully qualifying member names in your code. For more information, see Im ports Statement . 

• A valid data source path to your Excel spreadsheet. 

• A valid Excel version for the Extended Properties value. 

For Microsoft Excel 8.0 (97), 9.0 (2000) and 10.0 (2002) workbooks, use Excel 8.0. 
For Microsoft Excel 5.0 and 7.0 (95) workbooks, use Excel 5.0. 
For Microsoft Excel 5.0 workbooks, use Excel 4.0. 
For Microsoft Excel 3.0 workbooks, use Excel 3.0. 

• A valid reference to a table (or range) in the Excel workbook. 

To reference the complete used range of a worksheet, specify the sheet name followed by a 
dollar sign. For example: 

_j Copy Code 

select * from [Sheetl$] 

To reference a specific range of addresses on a worksheet, specify the sheet name followed by a 
dollar sign and the range. For example: 

_ j Copy Code 

select * from [Sheetl$Al : B10] 
To reference a named range, use the name of the range. For example: 

l^| Copy Code 

select * from [MyNamedRange] 

Robust Programming 

The data access (the call to the Fill method) should take place within a Try block, and the 
associated Finally block should close the data connection (with the Close method). This structure 
promptly closes the database connection when an exception occurs. 
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The following condition may cause an exception: 

• The underlying data provider for the OLE DB data source throws the error or warning. 

( OleDbExcept i on Class ) 

Security 

The application must have sufficient permissions to access the Excel file. 

See Also 
Tasks 

How to: Rea d Access Data i nto a D a taset (V isual Ba sic) 
How to: Read SQL Data into a Dataset (Visual Basic) 

Reference 

DataSet Class 
OleDbDataAdapter Class 
OleDbConnection Class 
Try. . .Catch. . .Fin a lly Stat eme n ts 

Other Resources 

Pre paring Your Application to Receive Data 
Editing Data in Your Application 



To make a suggestion or report a bug about Help or another feature of this product, go to the feedback site. 
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How to: Read Access Data into a Dataset (Visual Basic) 

See Also Exa m pl e 

y Language Filter: Visual Basic 

This example reads data from the Access Northwind database into a DataSet. 



Dim cn As System . Data . OleDb . OleDbConnect ion 
Dim cmd As System . Data . OleDb . OleDbDataAdapter 
Dim ds As New System . Data . DataSet ( ) 

cn = New System. Data .OleDb . OleDbConnection ( "provider=Microsof t . Jet .OLEDB . 4 . ; " & 
"data source=C: \Northwind.MDB" ) 

cmd a New System. Data. OleDb. OleDbDataAdapter ( "select * from Categories", cn) 




cn . Open ( ) 
cmd. Fill (ds) 
cn . Close ( ) 



This code example is also available as an IntelliSense code snippet. In the code snippet picker, it is 
located in Data - Designer features and ADO.NET. For more information, see H ow to: Inse rt 
Snippets Into Your Code (Visual Basic ). 

Compiling the Code 

This example requires: 

• A project reference to System.data.dll. 

• Access to the members of the Sy^tem.Data namespace. Add an Imports statement if you are 
not fully qualifying member names in your code. For more information, see Imports Sta tement . 

• A valid data source path to your Access database. By default, the path to the Northwind 
database is C:\Program Files\Microsoft Office\Office\Samples. 

3 Note 

The default installation of Access does not install the sample Access databases. You may need 
to run Office Setup to install the Northwind database. 

Robust Programming 

The data access (the call to the Fill method) should take place within a Try block, and the 
associated Finally block should close the data connection (with the close method). This structure 
promptly closes the database connection when an exception occurs. 

The following condition may cause an exception: 

• The underlying data provider for the OLE DB data source throws the error or warning. 

(Ole DbConnection class) 

Security 

The application must have sufficient permissions to access the database. 

See Also 
Tasks 
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Example 



Visual Basic 



_j Copy Code 
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How to: Read SQL Data into a Dataset (Visual Basic) 
Reference 

Try. ..Catch,-- Finally Statement (V isua l Basic) 
DataSet 

OleDbD ataAd apter 
OleDbConnection 

Other Resources 

Prep arin g You r Applicat ion to Rec eive Data 
Editing Data in Your Application 



To make a suggestion or report a bug about Help or another feature of this product, go to the feedback site. 
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